QuickPress  1997-01-27
This program is $10 shareware.

QuickPress is a small Macintosh application that lets you drag and drop text from
any application on your Desktop onto the Notepad on your Newton platform. 
It's also possible to paste text from an application that doesn't support 
Drag and Drop. You simply mark and copy the text you want to move and paste it over 
the QuickPress window. That's all you have to do! Simple and powerful!

With the QP Extension that is included in this kit, you can transfer text from your Newton to your Mac's clipboard or make a new text file. QP Extension currently supports the following stationaries: Notes, Outlines and Checklists. QP Extension will try to locate text in an unknown stationary, but the format will probably be lost.
If you are a developer and would like QuickPress to support your stationary. Send us a message and we'll look into it.

This package includes the following files:
*QuickPress Server 1.2 for the Newton.
*QuickPress Client 1.0 for MacOS.
*Readme text file.

*Tools folder with QP Extension and other tools.

What you need:
*Any Mac able to run Newton Backup Utility should work. You need the Serial Tool, AppleTalk ADSP, and the Drag manager.
*Our beloved friend the Newton.

If you have problems, check the bottom of this document.
Beta Testers should remove the old Prefs file before launching the application.

How it works

Install the QuickPress Server with your favorite package installer. The client should be ready to run as fast as youve unpacked the HQX file. We suggest that you keep the client icon on your desktop or in the Apple-menu so that it always is within reach.
When both applications are installed set their preferences so that they match each other. The preferences can be located under QP's InfoButton on the Newton and under "Default Behavior" at the Macintosh.
Hook up your Newton to the Mac with a standard Macintosh LocalTalk cable (i.e. serial cable). You can choose either the modem or printer port. You choose the port under Default  Behavior in the client. You are now ready to go to work.


How to connect

Serial connection:
Make sure that you've placed the Serial Tool in your system folder. 
First press the open connection button on the client then tap the connect button in the QuickPress application on the Newton. When using serial communications with QuickPress it's important that you always initiate the connection from the Macintosh.
Youre now connected! You can verify this by looking in the status drop down window. There you should see the name of the Newton that youve connected to and various other information. 

AppleTalk connection:
Make sure that you've placed the ADSP Tool in your system folder. 
Initiate the connection from both the applications. On your Newton will a network Chooser appear, choose the Macintosh that you would like to connect to by tapping on it. Then close the Chooser. QuickPress will now connect.

QuickPress is now active and ready to transfer.

Actually dropping it

When you find some text that you want to transfer to your notepad simply mark the text and drag it to the QuickPress window. When the windows frame lights up, drop the text (or clipping file). If the application that you want to drop from doesnt support Drag and Drop. Mark the text, copy it and paste it on the activated QuickPress window or press the paste button.
When youve dropped or pasted your text,  it is on its way through the connection and will in a matter of seconds be visible on the notepad. You should always await a plunk sound from the Newton after youve dropped text. This sound means that the Newton has received all the text without any problems. You now have the option to keep the connection and continue to transfer or you can quit.

From Newton to the Mac

When you are connected you can send text from ANY application on your Newton that supports selecting. Mark the text and tap the send button (marked with an arrow). QuickPress client puts the text on your clipboard or into a file depending on your choice.

QuickPress has to be in the front, otherwise the text will be lost. QuickPress will remind you of this. You will hear a little "plonk" when the text is received and the paste button will get a little red arrow. If you've chosen the Clipboard as the text destination you can now paste it wherever you like.

Quit

To drop the connection you choose close. The connection will also close correctly if you quit. Optionally you can tap Disconnect on your Newton.

At the Newton

The dropped text will be created as a new note in the unfiled folder. QuickPress doesnt support different styles but it will have the same layout as it had in the original app. You can treat the new note as a standard Newton generated note.
If you want to give your "QuickPressed" notes a different look can you choose a font for QuickPress to use under Preferences. Setting the "Use current UserFont" option is recommended if you want to gain speed.

Notes button to QuickPress

In the preferences you can choose to install an easy-access button to QuickPress in Notes. The button will place itself in Notes statusbar. By tapping the button will you open QuickPress without going to Extras first. 


Using the QuickPress Extension

The QP Extension lets you transfer complete notes from the Newton to your desktop computer over the QuickPress connection. 
You install the Extension as usual with your favorite Installer software. The Extension will only show in Notes routing list if QuickPress Server connected.

When your are connected just press the QuickPress item in the routing list (under the Envelope button) and the note will be QuickPressed to the clipboard or a file depending on
your client preference settings.

You can also QuickPress several notes, outlines and checklists at the same time from the overview. Just choose the ones you want to transfer and then tap the QuickPress item.

Problems

-I can't get a connection!

 Does the server and client communications preferences match?
 You may have selected the wrong port.
 Is the Serial Tool and the AppleTalk ADSP Tool installed in the system folder?
 It could be another application blocking the chosen port, try to terminate such apps.
 On older PowerBooks with built-in modem, you should set your preferences to "External Modem" when using serial connections over the modemport.


-My text is getting cut off, when I'm sending from the Mac!

This could happen If youre trying to drop a lot of text (more than 12000 characters). This is due to the Notepads memory limitations for each note. Try to stay within a couple of pages of text. If there is a problem, simply wait a while for the time-out and then reconnect.


-My text is getting cut off, when I'm sending from the Newton!

There might be some inktext in your notes. QuickPress will only send real text. Due to a protocol conflict will the Mac stop receiving when it is passed some ink. This error is on our agenda to be fixed.
If you're notes are mixed with drawings and regular text will QuickPress sort out the text, correctly.



QuickPress is shareware. Please register!

You only have to register the Newton part of QuickPress (i.e. the server). The client and the Extension are free. You are free to install the Client on so many computers that you want. The client will work with any Newton running Quickpress.
To register the server you must enter a personal Registration key. We provide you with this key when we receive your payment or a message from Kagi Shareware clearing house that you've paid.
Use Flash Sheridans Newton Register app. You can access this by tapping on the 
"$" diamond in the Register view. This will generate and fill out a register form for you, address it to Kagi Shareware clearing house and put it in your Newton's outbox. When Kagi Shareware receives it they'll handle your payment and notify us so that we can provide you with your Registration key.. If you dont like to pay by card choose the Query payment option and you will receive an email with further instructions. You can also send the registration fee directly to us at Avanti Software, Lilla Sdergatan 13, S-223 53 Lund, SWEDEN.

Be sure to ALWAYS provide us with your name spelled exactly as in your Owners Info on your Newton, your address and your email address when registering to us directly.

When you receive your personal Registration key tap the Register item under the InfoButton and enter your code, then tap Register. You are now registered. You should save your registration key just in case. If you loose your key we'll happily provide you with a new.



The QuickPress homepage: <http://lthmtek.msek.lth.se/~cim93hf4/quick.htm>

Newton Developer: Fredrik Holmn <mailto:cim93hf4@stud.msek.lth.se>
Macintosh Developer: Felix Hagno <mailto:hgus6@hgus.gu.se>

Avanti Software
Lilla Sdergatan 13
223 53 LUND
SWEDEN
T. +46 46 13 85 01
Mobile (SMS compatible): +46 705 55 00 52
<mailto:avanti@kagi.com>
<http://lthmtek.msek.lth.se/~cim93hf4/avanti.html>


Small Print

This program is Shareware, which means if you use it, you should send us US$10 or the equivalent amount in Swedish crowns.

You register the Newton app. The client (Mac based app) is free which you may install unmodified wherever you want. (a form of free License)

You may distribute this program any way you wish as long as you don't charge for it (except for reasonable download costs). We dont guarantee any support, but we will always answer your email. If we dont answer your email its because your message didnt get to us, or our reply bounced, so try again and include a valid internet address if you can.

Warranty

This program should do what weve described in this document.  If it doesnt, you can simply stop using it.  If you pay us, and within a year find that it doesnt do what we describe here, then you can notify us and we will refund your money and cancel your license.

Fine Print

Avanti Software hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchant ability or fitness for a particular purpose. Avanti Software will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Avanti Software or an agent of their has been advised of the possibility of such damages. In no event shall Avanti Software be liable for any damages, regardless of the form of the claim. The person using the software bears all risk as to the quality and performance of the software.


QuickPress is at your service!
